package com.it.schoolhomeos.repository;

import com.it.schoolhomeos.entity.User;
import com.it.schoolhomeos.enums.Role;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.stereotype.Repository;

import java.util.List;
import java.util.Optional;

/**
 * 用户数据访问接口
 * 
 * 提供对User实体的数据库操作方法
 * 继承JpaRepository以获取基本的CRUD操作
 */
@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    
    /**
     * 根据用户名查找用户
     * 
     * @param username 用户名
     * @return 包含用户信息的Optional对象，如果不存在则为empty
     */
    Optional<User> findByUsername(String username);
    
    /**
     * 根据角色查找用户列表
     * 
     * @param role 用户角色
     * @return 指定角色的用户列表
     */
    List<User> findByRole(Role role);
    
    /**
     * 检查指定用户名是否已存在
     * 
     * @param username 用户名
     * @return 如果用户名已存在则返回true，否则返回false
     */
    boolean existsByUsername(String username);
    
    /**
     * 根据角色查找用户
     * 
     * @param role 角色
     * @param pageable 分页参数
     * @return 分页的用户列表
     */
    Page<User> findByRole(Role role, Pageable pageable);
    
    /**
     * 根据角色和用户名或姓名模糊查询用户
     * 
     * @param role 角色
     * @param username 用户名关键词
     * @param name 姓名关键词
     * @param pageable 分页参数
     * @return 分页的用户列表
     */
    @Query("SELECT u FROM User u WHERE u.role = :role AND (u.username LIKE %:username% OR u.name LIKE %:name%)")
    Page<User> findByRoleAndUsernameContainingOrNameContaining(
            Role role, String username, String name, Pageable pageable);
} 